home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 2002 November / SGI Freeware 2002 November - Disc 2.iso / dist / fw_hylafax.idb / usr / freeware / catman / u_man / cat1 / faxcron.Z / faxcron
Text File  |  2002-07-08  |  4KB  |  107 lines
  1. FAXCRON(${MANNUM1_8})                FAXCRON(${MANNUM1_8})
  2.  
  3.  
  4.  
  5. NNAAMMEE
  6.        faxcron - _H_y_l_a_F_A_X routine maintenance script
  7.  
  8. SSYYNNOOPPSSIISS
  9.        $${{SSBBIINN}}//ffaaxxccrroonn [ --nn ] [    --ll _l_a_s_t_r_u_n ]
  10.  
  11. DDEESSCCRRIIPPTTIIOONN
  12.        ffaaxxccrroonn is a command script that    does routine upkeep tasks
  13.        in a _H_y_l_a_F_A_X spooling directory hierarchy.  This    script is
  14.        intended     to  be    invoked    from _c_r_o_n(${MANNUM1_8})    on behalf
  15.        of the fax user once a day, with    the standard output  sent
  16.        by  mail     to  the _H_y_l_a_F_A_X administrator.     For example, the
  17.        following crontab might be setup    for the    fax user:
  18.      25   23    *     *    *      sh ${SBIN}/faxcron | mail FaxMaster
  19.  
  20.        The _f_a_x_c_r_o_n script does the following work:
  21.  
  22.      report    statistics for facsimile transmitted  since  the
  23.       last time _f_a_x_c_r_o_n was    run.
  24.  
  25.      report    statistics for facsimile transmitted in    the past
  26.       week.
  27.  
  28.      report    statistics for facsimile received since    the last
  29.       time _f_a_x_c_r_o_n was run.
  30.  
  31.      report     statistics  for  facsimile received in    the past
  32.       week.
  33.  
  34.      report    any recent calls that  failed  suspiciously  and
  35.       return the associated    trace log;
  36.  
  37.      purge    data  that  is    30 days    or older from the remote
  38.       machine information directory;
  39.  
  40.      delete    information that is 30 days or older  from  ses
  41.       sion trace log files;
  42.  
  43.      remove    files from the tmp directory that are older than
  44.       1 day;
  45.  
  46.      remove    received facsimile that    are 7 days or older;
  47.  
  48.      report    sites that are currently having     jobs  rejected;
  49.       and
  50.  
  51.      force all session log files to    be owned by the    fax user
  52.       and kept with    protection mode    644.
  53.  
  54. OOPPTTIIOONNSS
  55.        --nn     Forces     _f_a_x_c_r_o_n  to  run  without  updating  any
  56.          files.
  57.  
  58.        --ll _l_a_s_t_r_u_n
  59.          Forces     the notion of the last    time that _f_a_x_c_r_o_n
  60.          was run to be _l_a_s_t_r_u_n.     The value of _l_a_s_t_r_u_n  is
  61.          a  date  and  time string of the form ``MM/DD/YY
  62.          HH:MM''  (the     _d_a_t_e(1)   format   string   ``%D
  63.          %H:%M'').
  64.  
  65.        --iinnffoo _n     Set  the  expiration  time  for data in the info
  66.          database to be    _n days.
  67.  
  68.        --lloogg _n     Set the expiration time for session log data  to
  69.          be _n days.
  70.  
  71.        --rrccvv _n     Set   the  expiration    time  for  files  in  the
  72.          received facsimile queue to be    _n days.
  73.  
  74.        --ttmmpp _n     Set the expiration time for  files  in     the  tmp
  75.          directory to be _n days.
  76.  
  77.        --mmooddee _m     Set the file protection mode for session logs to
  78.          _m (a command line argument to _c_h_m_o_d(1)).
  79.  
  80. NNOOTTEESS
  81.        This script requires _n_a_w_k(1) or _g_a_w_k(1)    and  a    _d_a_t_e  _(_1_)
  82.        program that supports the ``+format'' option.
  83.  
  84.        If session logs are to be kept private this script must be
  85.        modified    to filter out sensitive    information such as call
  86.        ing  card  numbers.   (It  should also be run with ``-mode
  87.        0600'' so that session log files    are  not  publicly  read
  88.        able.)
  89.  
  90. FFIILLEESS
  91.        ${SPOOL}                spooling area
  92.        ${SPOOL}/etc/lastrun        timestamp of last run
  93.        ${SBIN}/xferfaxstats        for    generating transmit statistics
  94.        ${SBIN}/recvstats        for    generating receive statistics
  95.        ${SPOOL}/tmp/faxcronXXXX        temporary file for truncating session logs
  96.        ${SPOOL}/tmp/faxlogXXXX        temporary file for logs of failed calls
  97.  
  98. SSEEEE AALLSSOO
  99.        _c_r_o_n(${MANNUM1_8}),   _f_a_x_q(${MANNUM1_8}),  _f_a_x_g_e_t_t_y(${MAN
  100.        NUM1_8}),    _f_a_x_s_e_n_d(${MANNUM1_8}),    _x_f_e_r_f_a_x_s_t_a_t_s(${MAN
  101.        NUM1_8}),  _r_e_c_v_s_t_a_t_s(${MANNUM1_8}),  _h_y_l_a_f_a_x_-_s_e_r_v_e_r(${MAN
  102.        NUM4_5})
  103.  
  104.  
  105.  
  106.                May 12, 1996        FAXCRON(${MANNUM1_8})
  107.